home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / mg2amint.lzh / readme.st < prev   
Text File  |  1993-04-05  |  5KB  |  141 lines
  1.     **** New mg2a port for ATARI and MINT ****
  2.     ****      Kees Lemmens; April 1993    ****
  3.  
  4. MG_MINT.TTP
  5. -----------
  6.  
  7. This is a complete (and working) version of MG especially for ATARI and MINT,
  8. which is based on the BSD-UNIX (SUN) sources.
  9.  
  10. Features :
  11. - Dired : works well. opens a pipe to the \bin\ls command, so this must be on
  12.   your system. For filecopy it relies on \bin\cp.ttp so if you want to use this
  13.   it must be on your system as well.
  14.  
  15. - Termcap : It has termcap handling, so you can use it on every terminal you
  16.   use to login on your ATARI. (I also use it over a modemline !)
  17.   It looks for environment variable TERM and uses this to look in \etc\termcap.
  18.   If either TERM or \etc\termcap is not found, it assumes vt52 handling.
  19.  
  20. - It can do all the regular expressions, just as the original code on SUN.
  21.   To do this I fixed a few bugs in the regex handling, mainly in the string 
  22.   functions.
  23.  
  24. - It first looks for a startupfile specified in environment variable MGINIT and
  25.   if this is not found for a file in the directory HOME with the name "mg.ini".
  26.  
  27. - It can use different sizes of terminals. It also looks for env. vars LINES
  28.   and COLUMNS (which is a SYS V feature !) to override the original settings
  29.   as defined in TERMCAP.
  30.  
  31. - Also runs on a normal ATARI, although then several features like subshells
  32.   and dired won't work.
  33.  
  34. - It makes backupfiles by changing the last character of a file or file exten-
  35.   sion into ~. This was necessary to deal with the stupid MSDOS-like filesystem.
  36.  
  37. - It can do the prefix-region command.
  38.  
  39. - The ATARI cursor keys are already defined in the code, so you don't need a
  40.   startupfile to define these.
  41.  
  42. - The apropos command works well, also if you just supply a <RET> as subject.
  43.   Previous releases of mg often crashed if you tried to do this.
  44.  
  45. - You can use \ and / in directory paths: both are recognised as regular
  46.   filenames.
  47.  
  48. - You can use ~username or ~ for your own homedirectory, but then it is neces-
  49.   sary to have an \etc\passwd file on your system. In the case of ~ there must
  50.   be an environment variable HOME.
  51.   
  52. - Ctrl-Z starts a new shell (as defined in SHELL) if SHLVL doesn't exist or
  53.   equals 0.
  54.   Otherwise mg sends itself a STOP signal, so you wil be temporarily returned
  55.   to the cal.ling shell. The default shell is \bin\MINTSHEL.TPP
  56.   
  57.       
  58. Bugfixes compared with the original (BSD) release:
  59.  
  60.  
  61. - The sizeof operator is now redefined to supply always an INT. This was neces-
  62.   sary because many systems return a LONG value nowadays and especially the
  63.   variable argumentlists would be completely corrupt if this would happen. 
  64.   This is because these functions always expect INT if a sizeof is being passed.
  65.  
  66. - Regex code uses a 0 value to pass an empty string. This causes bus errors on
  67.   many computersystems, so I changed these into dummy pointers.
  68.  
  69. - A strlen of a NULL pointer also causes buserrors. This is why I added a new
  70.   function "nstrlen", which first checks to see if the string is not a NULL
  71.   pointer before passing it to strlen. This was the main problem in the
  72.   apropos command.
  73.   
  74. - The variable argumentlist syntax wasn't correct on the TURBO C compiler, so 
  75.   I completely rewrote echo.c.
  76.  
  77. - include files stdio.h , stdlib.h and string.h are now always included to
  78.   avoid syntax conflicts.
  79.   Especially malloc caused problems as it is defined on many ANSI systems as
  80.   void * malloc() and not as char * malloc() .
  81.   
  82. - prefix was defined as a pointer to a function, so if we wanted to use the 
  83.   prefix-region code this caused conflicts.
  84.   Fixed by undefining this macro locally.
  85.  
  86. MG_ST.TTP
  87. ---------
  88.  
  89. - This is functionally identical to MG_MINT.TTP, but it uses the normal screen
  90.   handling and no termcap. This is why it only runs on the ATARI console and not
  91.   on other (remote) terminals. However it works in a ST52 window as opened by
  92.   TOSWIN.
  93.   Screen handling is faster than MG_MINT (especially on vt52) , but is not
  94.   portable.
  95.  
  96. - Dired uses internal functions for copy and ls, so it doesn't need externals.
  97.   The original bug in dired is fixed, so it is fully functional now.
  98.   
  99. - It starts a subshell if the variable SHELL is defined. If not, it is not
  100.    possible to start a shell.
  101.  
  102. - Regular expressions work now, just as good in the MINT or SUN) version.
  103.  
  104. - Cursor keys are predefined in the code, so the cursor keys will work now
  105.   without defining them in mg.ini. 
  106.   Also the HELP key is predefined.
  107.   
  108.  
  109. Bugfixes compared with the original code :
  110.  
  111.  
  112. - Many problems mentioned above also apply to the MG_ST version.
  113.  
  114. - There was a bug in the dired code : the attributes were not interpreted cor-
  115.   rectly so it was impossible to open a normal file from within a dired window.
  116.  
  117.  
  118.  
  119. -------------
  120.  
  121. If you have any questions or if you want the MINT sources, you can send mail
  122. or Email to :
  123.  
  124.     Kees Lemmens,
  125.     Fac. Technical Maths and Informatics.
  126.     Group Applied Analysis,
  127.     Delft University of Technology.
  128.     Mekelweg 4; Delft,
  129.     The Netherlands.
  130.  
  131.     Email : lemmens@dv.twi.tudelft.nl
  132.     
  133. Files in this archive :
  134.  
  135.     MG_MINT.TTP
  136.     MG_ST.TTP
  137.     MG_MINT.INI    (define MGINIT or rename to mg.ini)
  138.     MG_ST.INI    (same)
  139.     README.ST
  140.  
  141.